Вновь устанавливает перечислитель на начало последовательности.
HRESULT Reset();
Параметры
Нет.
Коды возврата
Из возвращенного HRESULT получают один из следующих
кодов возврата:
Код возврата | Значение |
S_OK | Успех. |
S_FALSE | Ошибка. |
Комментарии
При повторном перечислении не гарантируется возврат той же
самой последовательности вариантов, что и при первом. Хотя точное повторение и
желательно, результат зависит от перечисляемого набора. Для некоторых наборов
выполнение этого условия может оказаться непрактичным (например, в случае
перечисления файлов в каталоге).
Пример
Следующий код реализует IEnumVARIANT::Reset для наборов из
примера Lines (файл Enumvar.cpp).
STDMETHODIMP CEnumVariant::Reset() { m_lCurrent = ra_lLBound; return NOERROR; }